dbCatenate

Section: User Commands (1)
Updated: June 6, 1989
Index Return to Main Contents

NAME

dbCatenate, dbCompare, dbCompress, dbCopy, dbDescribe, dbExpand - hashed database utilities

These commands, found in /usr/lib/database, are utilities for managing hashed databases created with db(3).

dbCatenate [-x] databases ...: Catenates the key/content pairs stored in the specified databases to the standard output. The order is uninteresting, being determined by a hash function. -x catenates a hexadecimal ASCII representation of the information.

dbCompare [-v][-V] from-database to-databases ...: Compares from-database with to-databases, looking up each key found in from-database in each of the to-databases, and testing the associated contents for equality. Normal operation is silent, indicating failure by a non-zero exit value. -v prints a brief synopsis of each conflict and a brief summary. -V additionally prints a hexadecimal ASCII representation of missing keys and conflicting contents, as in dbCatenate.

dbCompress [-p] databases ...: Compresses databases, reducing the amount of disk space they consume. Compressed databases are readable only, and do not support writing or deletion.

dbCopy [-s size] from-database to-databases ...: Copies key/content pairs from from-database, creating to-databases with block size LEAFSIZE, as defined in db.h. -s changes the block size to size.

dbDescribe databases ...: Prints useful information about databases, including the block size, the number of blocks, the number of key/content pairs, the average number of key/content pairs per block, and the average block usage as a percentage of total block space.

dbExpand databases ...: Reverses the compression performed on databases by dbCompress. After expansion, databases will again support writing and deletion.

In the event of an error, these commands print a diagnostic message to standard error, and exit with a non-zero value.

This document was created by man2html, using the manual pages.
Time: 17:20:08 GMT, March 25, 2025